PESoundInput Plugin is a REALbasic plugin to monitor the sound input on a Mac. The
current sound input can be set in the "Monitors and Sound" control panel.
USE
To use the plugin, simply drop it into a folder emtitled "Plugins" in the same folder as your REALbasic application. Start REALbasic and you will have access to three functions:
"PEInitLevelMeter() as integer" - Initializes the sound input. This must be called before anything else! The return value is inconsequential in this version.
"PEGetLevel() as integer" - Retrieves the Current Level of the Sound Input. Returns a integer between 0 and 255.
"PECloseLevelMeter() as integer" - Close the Sound Input. Don't forget to call this when you're finished. Again, the result is inconsequential in this version
KNOWN LIMITATIONS
Retrieving the sound input level for metering purposes is considered by many programmers to be a giant waste of CPU cycles. But, it is fun to watch and use. If your meter looks too jittery or not responsive enough, try changing the period of the timer. At this time, the input is strictly mono. This will work OK for the microphone input, but might not suite your needs for stereo audio. Maybe sometime in the future..... (-:
THE DIRT
Although PESoundInput Plugin is freeware, it is still the property of Purple E Software. If you would like to include it on your site or CD-ROM, please be sure to include this README file unaltered with it. If you would like to make mention of PESoundInput Plugin when you use it for products, shareware, or freeware, we'd sure appreciate it.
